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which vary from state to state. 


Except as specified above, DCA MAKES NO WARRANTIES OR REPRESENTATIONS, EXPRESS 
OR IMPLIED, REGARDING THE PRODUCT OR ANY PROGRAMS, MEDIA OR MANUALS 
THEREIN, AND EXPRESSLY DISCLAIMS THE WARRANTIES OF MERCHANTABILITY AND 
FITNESS FOR A PARTICULAR PURPOSE. DCA does not warrant that the Programs (or any other 
DCA programs contained or used with the product including any maintenance modifications or 
updates) will meet your requirements or that their operation will be uninterrupted or error free. 


If any part of this product is not as warranted above, DCA will, at its option and as your exclusive 
remedy, either (1) repair or replace the nonconforming item at no cost to you, or (ii) refund your money, 
provided you request from DCA a Return Authorization (RA) Number and return the product, with 
proof of the date you obtained it and with the RA Number indicated, to DCA within ten (10) days after 
the expiration of the applicable warranty period. 


THE WARRANTIES AND REMEDIES SET FORTH ABOVE ARE EXCLUSIVE AND IN LIEU OF 
ALL OTHERS, ORAL OR WRITTEN, EXPRESS OR IMPLIED. Statements or representations 
which add to, extend or modify the warranties or remedies are unauthorized by DCA and should not be 
called upon by you. 


DCA OR ANYONE INVOLVED IN THE CREATION OR DELIVERY OF THIS PRODUCT TO 
YOU SHALL HAVE NO LIABILITY TO YOU OR ANY THIRD PARTY FOR SPECIAL, 
INCIDENTAL, OR CONSEQUENTIAL DAMAGES (including, but not limited to loss of profits, or 
savings, downtime, damage to or replacement of equipment and property or recovery or replacement of 
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THE POSSIBILITY OF SUCH CLAIM OF DAMAGE. DCA'S LIABILITY FOR DIRECT 
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U.S. GOVERNMENT RESTRICTED RIGHTS 


The Programs and manuals are provided with RESTRICTED RIGHTS. Use, duplication, or disclosure 
by the Government is subject to restriction as set forth in subdivision (c) (1) (ii) of the Rights in 
Technical Data and Computer Software clause at 252.227-7013. Contractor/ manufacturer is Digital 
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Welcome to 
Irma 


Task List 


Thank you for buying Irma™ for 
Learn about Irma the Mainframe (referred to as 
Complete your planning Irma). We at DCA® hope this 
checklist product meets your needs and is 
install Irma easy to use. If you have any ideas or 
Learn about online help suggestions, please call us at 
Configure the connection and 1-800-348-3221. 

start a communications session 

Customize your session We want to hear from you so that 
we can continue to offer the finest 
products available. 


This chapter gives you an overview 
of how this guide is designed. 


How this guide is designed 


The “Task List,” shown above, appears on the second page of every chapter, 
showing you the tasks necessary to install, configure, and use Irma. As you 
move through the book, the current task is highlighted, allowing you to track 
your progress and see what lies ahead. 


Why read this guide? 


You need to read this guide to understand the Irma features and the 
connectivity types it offers. This guide also describes the tasks needed to 
install Irma. 


Most of the information that you’ ll need to configure, customize, and use 
Irma is contained in the online help. This guide teaches you how to use online 
help, and gives you specific topics to reference in the online help. 


You’ll find it easier to understand this guide and use Irma if you are familiar 
with Windows and with the type of connectivity you will be using. 


On the next page, the road map shows you how to use this manual. 


Introduction 
You are here. 


TREES nen Sen 


Chapter 1 
Learn about the features of Irma. 


Chapter 2 
Read to find out everything you 
need to do before you install Irma. 
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Chapter 3 
Follow the instructions to install 
Irma. 


nceietetstacstnietofarcennsnteteieteresetetetelvinenteteitetasennietriintnietecetnetesetetnieieieteteteteeteteteeeteteitsteneseeesteieterstpsemreteetarenetee 
senanesteenenianetnscteeahcienee at erteeeeneetoseene eect ete rete ee aaa ee aaa eer totter 


Chapter 4 


Follow the instructions to learn how 
to use online help. 


- Chapter 5 
Follow the instructions to configure 
and start a session, and find out 
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Irma road map 
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Documentation conventions 


The following documentation conventions are used in this guide: 


bold In command lines, bold represents information that 
you should enter exactly as shown. 


italics Italics represent variable information. In command 
lines, do not enter the words themselves in the 
command; enter the information they represent. 


A key name, for example, , refers to a specific 
key on the keyboard. 


If you have remapped the function originally 
mapped to the key, substitute the new key or key 
combination for the original. 


Note This signifies important additional information. 


Caution This signifies that a failure to follow the recom- 
mended procedure could result in a loss of data or 
could result in the product not performing properly. 


Summary 


After reading this chapter, you should know the following: 


L) What the Getting Started Guide contains 
L) The documentation conventions used in the guide 


LJ How to get additional information 


In the next chapter, you’ll learn more about Irma and the connectivity types it 
offers. | 
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This Is Irma 


¢ What is Irma? 1-2 
¢ Features 1-7 
¢ What's new with Irma? 1-11 
e About the Irma applications 1-13 
e About the file types used by Irma 1-15 
¢ Summary 1-16 


Chapter 1 


The Task List at left shows the current 
step in the process of installing and using 


Irma. 
Task List 


In this chapter, you will learn about the 
Learn about Irma Irma features and the connectivity options 
Complete your planning you can install. You’ll also learn about the 
checklist differences between Irma and previous 
Install Irma DCA products. You will be introduced to 
Learn about online help the new Irma icons, and you’ll learn 
about the file types that Irma uses. 


Chapter 1 


Configure the connection and 
start a communications session 


You’ll need about 15 minutes to read this 


Customize your session 
chapter. 


What ts Irma? 


Irma for the Mainframe Software for Windows (referred to as Irma) is com- 
munications software that allows a PC running Microsoft® Windows™ or 
Windows for Workgroups to communicate directly with other computers 
using a variety of connectivities. 


Irma can connect to a single host, to multiple hosts, or to peer computers 
across an SNA network. 


You have two choices when you install the mainframe connectivity: 


e¢ You can install any number of standalone and gateway connection types. 


or 


e You can install one server connection type. Chapter 1 


Examples of the mainframe connection types are shown in Figure 1-1. 
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Figure 1-1. Examples of mainframe connection types 
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The mainframe connection types are described in Table 1-1. 


Table 1-1. Description of mainframe connection types 


Installation Connection 


Chapter 1 choices type Description 
Standalone Single-session Irma supports single-session CUT 
connections (CUT) connectivity for a direct connection to an 
IBM® 3174/3274 control unit. 
Multisession Irma supports multisession DFT 
Coax (DFT) connectivity for a direct connection to an 


IBM 3174/3274 control unit. Each DFT 
adapter can only support up to five 
emulation sessions. 


LAN Attached __ Irma supports standalone, multisession 
(802.2) 802.2 connectivity with host and peer 
computers across a token-ring or Ethernet 
LAN through the IEEE standard 802.2 
data link control protocol. For stand-alone 
connectivity, you can use the following 
token-ring or Ethernet connections: 
¢ Connection to a 37xx front-end 
processor connected to a host 
® Connection to a 3174 control unit 
connected to a 37xx front-end 
processor and through the front-end 
processor to a host 
* Connection to a 9370 ICU connected 
internally to the 9370 host 
¢ Connection to a 3174-xL control unit or 
3174 local controller directly connected 
through a channel to a host 


Remote (SDLC) Irma supports direct, multisession SDLC 
connectivity to a 37xx front-end processor, 
through an SDLC adapter and half-duplex 
synchronous modems, over switched or 


leased lines. 
X.25 Irma supports direct, multisession X.25 
Standalone connectivity to a 37xx front-end processor, 


through an X.25 adapter and half-duplex 
synchronous modems, over switched or 
leased lines. 


Note _|n order to install X.25 connectivity, 
you must order the optional Irma 
X.25 Connection diskette from 
DCA. For ordering information, see 
“Ordering optional software” on 
page 2-3. 
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Table 1-1. Description of mainframe connection types (cont.) 


Installation Connection 


choices type Description 

Standalone 1TN3270 over If you are a client on a TCP/IP network, 

connections TCP/IP you can access a TN3270 controller or 

(cont.) gateway by using a supported TCP/IP Chapter 1 


protocol stack and a LAN adapter. No 
additional adapter is required for your PC. 
Irma is supported with the following TCP/ 
IP stacks: 

¢ Winsock 1.1, including Chameleon™ 
from NetManage™, TCP/IP for 
Windows version 3.1, IBM TCP/IP for 
DOS 2.1, SNAP-IX 

Novell® LAN Workplace® 

FTP Software PC/TCP™ 

Wollongong Pathway 

Sun® PC-NFS™ 

Microsoft LAN Manager or 3Com® 
Walker Richer & Quinn (WRQ) 
Frontier Super TCP/NFS 

DEC® PATHWORKS™ 


Gateway ATLANTIS SNA_ If you are a client on a LAN, you can 

connections Gateway access an ATLANTIS SNA Gateway by 
using a LAN adapter configured to use the 
same protocol as the gateway. No 
additional adapter is required for your 


client. 
Digital SNA If you are aclient ona PATHWORKS LAN, 
Gateway you can access a Digital SNA Gateway by 


using a LAN adapter configured to use any 
protocol supported by PATHWORKS. No 
additional adapter is required for your 


client. 
Eicon SNA If you are a client on a LAN, you can 
Gateway access an Eicon SNA Gateway by using a 


LAN adapter configured to use the same 
protocol as the gateway. No additional 
adapter is required for your client. 


DCA If you are a client on a LAN, you can 
IrmaLAN™ access an IrmaLAN Gateway (for VINES®, 
Gateway NetBIOS, or NetWare®) by using a LAN 


adapter and the appropriate (VINES, 
NetBIOS, or IPX/SPX) protocol . No 
additional adapter is required for your 
client. 


Table 1-1. Description of mainframe connection types (cont.) 


installation Connection 


choices type Description 

Gateway DCA Netway® If you are a client on a LAN, you can 

connections 2000 Gateway access a Netway 2000 gateway by usinga 
Chapter 1 (cont.) LAN adapter configured to use the same 


protocol as the gateway. No additional 
adapter is required for your client. 


Novell NetWare If you are a client on a LAN and have 

for SAA™ access to a NetWare for SAA gateway, 

Gateway you can access the server by using the 
SPX/APX or TCP/IP protocol and a LAN 
adapter. No additional adapter is required 
for the client. You can have simultaneous 
sessions using both IPX/SPX and TCP/IP 


protocols. 
Server Microsoft SNA _ If you are aclient on a LAN and have 
connections Server access to an SNA Server, you can access 


the server by using the NetBEUI, SPX/IPX 
or TCP/IP protocols and a LAN adapter. 
No additional adapter is required for the 
client. 


DCA Select™ If you are a client on a LAN and have 

Comm Server _ access to a Select Comm Server, you can 
access the server by using the NetBEUI, 
SPX/IPX or TCP/IP protocols and a LAN 
adapter. No additional adapter is required 
for the client. 


Hewilett- If you are aclient on aLAN and have 
Packard® access to an HP-UX SNAplus Server, you 
HP-UX SNAplus_ can access the server by using the 
Server NetBEUI, SPX/IPX or TCP/IP protocols 


and a LAN adapter. No additional adapter 
is required for the client. 


Winsock TCP/IP If you are a client on a LAN and have 
access to a SNAP-IX server, you can 
access the server by using the Winsock 
1.1 TCP/IP protocol. No additional adapter 
is required for the client. 


Features 


Table 1-2 describes the Irma features. 


Table 1-2. Irma features 


Feature 
Application 
Programming 
Interface (API) 


Autosizing of 
fonts and 
session window 


Character 
support 


Diagnostics 


Dynamic Data 
Exchange (DDE) 
support 


File transfer 


Graphics 


HLLAPI 


Chapter 1 


Description 

The mainframe connectivity supports Advanced 
Program-to-Program Communication (APPC), 
Common Service Verbs (CSV), and Common 
Programming Interface Communications (CPI-C). 
Windows Open Systems Architecture (WOSA) APPC 
and CPI-C are also supported. 


Note Supported only with DFT, SDLC, 802.2, Select 
Comm Server, and SNA Server. 

You can choose to have the fonts automatically resize 

within the display window, or to have the window 

automatically resize to accommodate the font size. 


You can choose to use Country Extended Code Page 
(CECP), Extended Attribute Byte (EAB), and A 
Programming Language (APL). TrueType™ fonts 
(fixed pitch only) are also supported. 


The mainframe connectivity offers diagnostics for CUT, 
DFT, 802.2, SDLC, and X.25 connection types. 


You can link Windows applications using a protocol 
called Dynamic Data Exchange (DDE). Using DDE, 
you can transfer data on a one-time basis, or establish 
an ongoing dialog with other applications. 

You can perform multiple, concurrent file transfers to 
and from CICS, CMS, and TSO host environments 
using the following: 

¢ DCA FT/Express™ 

© DCA IrmaLink® 

¢ IBM 3270 IND$FILE 

e PS/CICS 


Note |rmaLink is not supported with Select Comm 
Server. 


You can install the Irma Graphics software that is 
included with Irma. The mainframe connectivity 
supports All Points Addressable (APA) and 
Programmed Symbols (PS) graphics. 

Note Not available for CUT. 


You can use WinHLLAPI, EHLLAPI, and DOS HLLAPI 
with the mainframe connectivity. 
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Table 1-2. Irma features (cont.) 


Feature Description 

Input devices You can use the mouse to emulate a light pen. In 
addition to standard PC keyboards, the mainframe 
connectivity also supports the following keyboards: 

Chapter 1 © DCA IrmaKey/3270® 

Memorex-Telex 

Key Tronic® 

Siemens/Nixdoft 122-key 

IBM 122-key keyboards 


Keyboard You can change the location of the characters and 

mapping functions on your keyboard using the Keyboard Editor. 
You can also assign scripts and keystrokes to specific 
keys. 


LUA The mainframe connectivity supports both LUA and 
WOSA LUA. 


Macros You can save keystrokes and assign them to a 
QuickPad™ or a keyboard key. 


Microsoft Office |The mainframe connectivity supports the Microsoft 
Compatible Office Compatible Program. 
Program support 


Multiple You can view multiple windows concurrently, in either a 

document cascaded or tiled format. You can reduce a window to 

interface (MDI) an icon and close all windows simultaneously. 

NetView® You can communicate with IBM NetView through 3270 
user alerts 


Note Supported only with DFT, SDLC, 802.2, Select 
Comm Server, and SNA Server. 


NetWizard™ If you purchased a multipack version of Irma, the 
NetWizard software is included. You can install the 
NetWizard feature, which allows you to manage 
distributed software applications across your LAN. 


Printer emulation You can configure a 3287 printer emulation session, 
that supports LU1 and LU3 type printing. 


Note 1N3287 printing (LU1 and LU3) is supported 
with OpenConnect® System (OCS) TCP/IP- 
SNA Gateways and McData 6100/6200 
controllers only. 


Printer server You can use the printer emulator as a print server, 
capabilities including font mapping. 
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Table 1-2. Irma features (cont.) 


Feature 
Profiles 


QuickBar 


QuickDDE 


QuickExec™ 


QuickHit™ 


QuickPad 


QuickSAA 


QuickScript™ 


QuickSend 


Response Time 
Monitor (RTM) 


Description 

A profile contains the name and description of the host 
system. The profile also contains connection 
information, terminal emulation settings, and keyboard 
definitions. The software includes a default session 
profile and several profiles that have already been 
configured and are ready to use to connect to the host. 


The QuickBar displays icons that initiate tasks, such as 
file transfers and screen captures. You can start these 
tasks quickly by clicking on the icons. For mainframe 
connectivity, you can also customize your QuickBar by 
moving and deleting icons. You can even create your 
own QuickBars. 


You can use this tool to simplify the process of 
developing a DDE link between Irma and another 
application. 


You can define a set of applications to execute when a 
single icon is selected. 


QuickHit lets you use the mouse to choose characters, 
words, or function keys displayed by the mainframe 
application, and send them to the host. 


During a communications session, you can execute 
commands using a QuickPad instead of your 
keyboard. A QuickPad is a small window you create 
that contains objects you click on to initiate host 
commands You can also assign functions to different 
objects on a QuickPad, such as running scripts or 
sending keystrokes to the host. 


You can select a host menu item by using the mouse. 
The menu item is then entered automatically in the 
data field. 


You can create, edit, compile, and run scripts using the 
QuickScript editor and the SISL scripting language. 


You can use the Windows File Manager and the drag- 
and-drop feature to initiate file transfers from your PC 
to a CICS, CMS, or TSO host environment using 
IND$FILE or IrmaLink. 


Note |rmaLink is not supported with Select Comm 
Server. 


You can display RTM in graphical format. 


Note Supported only with DFT, SDLC, 802.2, Select 
Comm Server, and SNA Server. 
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Table 1-2. 


Feature 
Screen capture 


Screen 
customization 


Scripts 


Shared access 


Terminal 
emulation 


Text files 


Uploading ASCII 
text files 


Irma features (cont.) 


Description 

During a communications session, you can copy the 
contents of the terminal screen and save it in a file, or 
you can send it to a printer. 


You can customize your screen display, such as the 
character fonts, colors and audible signals, by 
modifying the terminal emulation settings. 


You can record and save a series of keystrokes to 
perform a task. You can also create, compile, and run 
scripts using the Script Editor and the SISL™ 
language. 


You can choose to install Irma with shared access. This 
means that one copy of the Irma program files is 
installed to a server, and multiple users can run Irma at 
the same time. This type of installation also requires 
you to run a Setup program at each workstation that 
installs the Irma program group, and installs some files 
into a private directory for that workstation. 


You can use up to five concurrent mainframe sessions, 
using models 2 through 5. You can choose to use “any” 
model type so that your display window accommodates 
any model that the host application is using. You can 
even conduct display emulation through the serial port 
on your PC. 


You can cut, copy, and paste text and tables between 
the host and the PC. 


During a communications session, you can send an 
ASCIl text file to the host computer. 
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What’s new with Irma? 


If you have previously used IRMA WorkStation for Windows, you may 
notice several changes in the Irma product, as follows: 


¢ You no longer configure your communications adapters and connections Chapter 1 
by running the Setup program. After you have installed Irma and you start 
the appropriate application, you are prompted automatically to configure 
your adapters and connections. Later, if you need to make changes to the 
configuration, you can do so from the display application. 


e If you install Irma with Shared Access, and you run the Setup at the 
workstation that wants to use the shared access software, you must supply 
a private path for that workstation. You no longer specify a private path if 
you install Irma as a Personal Copy. 


The biggest change is that many of the icons that you used to see in the IRMA 
WorkStation for Windows program group are gone. The applications that you 
are familiar with are still in the product, but you now access those 
applications from one of the new Irma icons. For descriptions of the new 
icons contained in the Irma program group, see “About the Irma applications” 
on page 1-13. 


The following sections describe how to access the applications that you used 
in a previous DCA product. 


Icons you saw in IRMA WorkStation for 
Windows 


When you first access the Irma program group, you may notice that there are 
fewer icons than you saw in the IRMA WorkStation program group. 
Applications that once had separate icons in the program group are now 
integrated and available through Mainframe Sessions. 
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Table 1-3 presents the icons that appeared in the last version of the IRMA 
WorkStation product, and tells you how to access the associated application 
in Irma. 


Table 1-3. Accessing applications in Irma versus 
Chapter 1 IRMA WorkStation for Windows 


To access this application in Irma, start 
IWW 2.x icons Mainframe Sessions and... 
QuickScript Choose Run, Edit, or Learn Script from the 
ne QuickTools menu. 


Choose New Printer from the File menu. 


Choose Session Configuration from the Settings 
menu. 


Choose Diagnostics from the Help menu. 


Choose Edit QuickExec from the QuickTools menu. 


Keyboard Choose Select Keyboard or Edit Keyboard from the 
Editor Settings menu. 


APPC APPC connectivity is available through a new API 
ak program group icon. 


About the Irma applications 


Based on the connectivity type you select during the Irma installation, the 
associated applications are installed. Table 1-4 describes the Irma 
applications. 


Chapter 1 


Table 1-4. Irma applications 


Application Description 


iad Use this application to start, configure, use, and 
ag customize mainframe display and printer sessions. 
Mainframe You can capture emulation screens to the disk or the 
Sessions printer, edit screen contents, and run HLLAPI 
programs. 


Several options are found under Mainframe 

Sessions menus that were formerly separate 

program group icons, such as: 

® To configure a mainframe session, choose 
Session Configuration from the Settings menu. 

¢ To start, use, and customize mainframe display 
sessions, choose New Display from the File 
menu. 

® To start, use, and customize mainframe printer 
sessions, choose New Printer from the File menu. 

© To select or edit a keyboard, choose Select 
Keyboard or Edit Keyboard from the Settings 
menu. 

¢ To work with QuickScript, choose Run, Edit, or 
Learn Script from the Quicktools menu. 

© To edit a QuickExec file, choose Edit QuickExec 
from the Quicktools menu. 

¢ To access diagnostic information, choose 
Diagnostics from the Help menu. 


Use this application to start an SNA (LU 6.2) session 
that can be used by APPC transaction programs or 
CPI-C applications. The session is automatically 
started for you. For information about APPC, see the 
DCA APPC Programmer's Guide provided in the 
optional DCA Distributed Applications Developer's 
Tool Kit. For information on ordering this tool kit, see 
“Developing your own applications” on page 5-6. 


Note APPC support is not available for CUT, 
TN3270, IrmaLAN NetBIOS, IrmaLAN IPX/ 
SPX, IrmaLAN VINES, Eicon SNA Gateway, 
Digital SNA Gateway, ATLANTIS SNA 
Gateway, and Netway 2000 Gateway. 
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Table 1-4. Irma applications (cont.) 


Application Description 
Use this application to start the DOS HLLAPI 
redirector feature. 


chaser | Redirector 
f Use this application in conjunction with the 
ee QuickExec feature. After you have set up your 
eee QuickExec profile that executes a set of applications, 


you assign that profile name to this icon. Clicking on 
this icon then starts all the associated applications. 


After you install Irma, use this application to add 
connection types, install an option disk, change the 
program group, change the keyboard driver, or 
change the host language. This application is 
installed automatically. 


information about the product. This icon is added 


Read this file first to learn important, additional 
y 
| automatically to the program group. 


Read-This 


About the file types used by Irma 


Irma uses several file types to store your configuration and customization 
information. 


The Mainframe Sessions application uses several file types to store your Chapter 1 
configuration and customization information. Table 1-5 presents the file 
types, their extensions, and a description of each file type. 


Table 1-5. File types used by Mainframe Sessions 


File 
File type extension Description 
Style file .CCF Contains session configuration information. 


Only one style file can be in use at one time. 
Settings contained in this file apply to all 
active mainframe sessions. 


You can invoke a customized style file by 
adding the style filename to the mainframe 
session command as follows: 


EMU /style_file.CCF 


Display profile .EMU Contains configuration information about the 
display window size, fonts, and colors. It 
also allows the session to be activated 
automatically. There is one profile per 
mainframe display session. 


To invoke a customized profile, add the 
profile name to the mainframe display 
command as follows: 


EMU.EXE profile.EMU 


File transfer = .FT Contains configuration information about file 

profile transfers including type of file, direction of 
the transfer, and the host filename type 
mode. You can create multiple file-transfer 
profiles, but you can invoke only one profile 


at a time. 
SISL source ISL Contains stored keystrokes, along with SISL 
file commands. This file can be edited by the 
QuickScript Editor or any text editor. 
SISL ASX Contains the compiled output of a SISL 
compiled file source file. This is an executable file. 
Keyboard .KBD Contains information about the keyboard 
profile mapping. You can use only one keyboard 


profile at a time. 


Table 1-5. File types used by Mainframe Sessions (cont.) 


File 

File type extension Description 

Log files .LOG Contains audit information when you use the 
diagnostics feature. 

Chapter 1 : : : P : i ‘ 

Printer profile .PRT Contains configuration information about 
mainframe printer emulation. There is one 
profile per mainframe printer session. 

QuickPad .QBD Contains the definition for a QuickPad, 

profile including the size and key layout. You can 
use only one QuickPad at a time. 

QuickExec -.QEP Contains configuration information that 

profile allows you to start multiple applications by 
clicking on a single icon. 

Screen SCR If you perform a screen capture and save 

capture that screen capture to a disk file, the 
extension used is .SCR. 

Trace files TRC Contains tracing information. You initiate. 


traces by using the diagnostics feature. 


Summary 


In this chapter, you learned about the following: 


QO) What Irma is, the connectivity types supported, and the features 
provided | 


Q) The differences between Irma and previous DCA products 
QO) The applications that are included 


QO) The file types that Irma uses 


Now turn to the next chapter to prepare for installing Irma. In Chapter 2, 
“Before You Install Irma ,” you will complete planning checklists that make 
installing Irma easier. 


4 


ee ea ee ee 
1-16 Let OYEEY OEY YP 
EAE FAS IIS YF 


Before You Install Irma 


¢ Checking your package contents 2-2 
¢ Ordering optional software 2-3 
e Hardware requirements 2-3 
¢ Software requirements 2-6 
¢ Upgrading from a previous version of a DCA product 2-9 
e Installation checklists 2-10 
¢ Summary 2-15 


Chapter 2 


Resist the temptation to run the 
Setup program before you read this 
chapter! 


Task List 


This chapter describes the Irma 
package contents, and explains how 
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Complete your planning to order optional software. This 
checklist chapter lists all the hardware and 
Install Irma software requirements for each con- 
Chapter 2 Learn about online help nection type. If you have a previous 
Configure the connection and DCA product installed, you’ ll learn 
start a communications session how to upgrade to Irma for the 
Mainframe. 


Customize your session 


You’ ll need about 15 minutes to 
read this section and complete the 
checklists. 


Checking your package contents 


In addition to this Getting Started Guide, make sure your package includes 
the 3.5” high-density diskettes shown in Table 2-1. 


Table 2-1. Irma diskettes 


Disk label Description 

Mainframe Program These diskettes contain all of the program 
Disks 1—5 files for mainframe connectivity. 
Mainframe Language This diskette contains language files. You 
Support Disk will need this diskette if you choose to 


install a language other than U.S. English. 
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Ordering optional software 


DCA offers optional software packages that can enhance the Irma feature set, 
as described in Table 2-2. 


Table 2-2. Irma optional software 


Disk label Description 


X.25 Connection Disk Optional. This diskette provides X.25 
support for mainframe connectivity. 


Irma Graphics for This package contains the Irma Graphics i ol 
Windows software and a User’s Guide, and can be 

installed if you want APA graphics 

capabilities. 


To order any of these products at a substantial discount, call DCA Sales 
Operations at 1-800-348-3221, extension 809. 


Hardware requirements 


Irma requires the following hardware: 


e Any PC, monitor, mouse, and keyboard supported by Windows 3.1 or 
Windows for Workgroups 3.11. 


¢ A minimum of 4 MB of system RAM, 6 MB is recommended. 
¢ A printer supported by Windows 3.1 (optional). 


e¢ A minimum of free hard-disk space as described in Table 2-3. 


Table 2-3. Hard-disk space requirements 


Standalone CUT 6.7 
DFT 8.3 
802.2 8.0 
SDLC 7.9 
X.25 8.0 


TN3270 7.0 
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Table 2-3. Hard-disk space requirements (cont.) 


Gateway ATLANTIS SNA Gateway 7.2 
Digital SNA Gateway 7.5 
Eicon SNA Gateway 7.0 
IrmaLAN IPX/SPX 7.2 
IrmaLAN NetBIOS 7.2 
IrmaLAN for VINES 8.1 
NetWare for SAA 5 

Chapter 2 

Server HP-UX SNAplus Server 6.5 
Select Comm Server 6.1 
SNA Server for Windows NT_ 8.7 
Winsock TCP/IP client 7.0 

All standalone and 10 

gateway connections 

(except X.25) 


You can install more than one standalone and gateway connection type, or 
you can install one server connection type. 


Note  Youcan install multiple connection types; however, you can activate 
only one connection type at a time. 


¢ A minimum of 1 MB of additional system RAM if you are using Irma 
Graphics for Windows. Additional RAM will improve performance if you 
are displaying multiple complex graphics. 


°¢ One of the following adapters: 


- If you install Irma with a gateway or server connection type, you need 
to install a LAN adapter supported by the LAN operating system. 


- If you install Irma with a standalone connection type, you need to 
install at least one communications adapter. 
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Table 2-4 lists the communications adapters supported by Irma. 


Table 2-4. Communications adapters supported by 
Irma 


Connection Supported adapters 
CUT and DFT DCA Irma 2, Irma 3®, Irma 3 Convertible, and Irma 
3270 Pocket adapters 


IBM 3278/79 Emulation Adapter (including Rev B), 
3278/9 Advanced Emulation Adapter (including 
Rev B), 3270 Connection Adapter, Model A Chapter 2 
(including Rev B) and Model B (including Rev B) 


Attachmate® Advanced 3270 Adapter and 
Advanced 3270 Adapter/2 


SDLC DCA Synchronous Communications Adapter 
(SCA) 


IBM SDLC Adapter, Multiprotocol Communications 
Adapter/A 


Pathways SDLC Adapter 


802.2 Microdyne IrmaTrac™ Convertible Token-Ring 
Adapter 


IBM Token-Ring Adapter, Token-Ring Adapter II, 
Token-Ring Adapter/A, Token-Ring 16/4 Adapter, 
Token-Ring 16/4 Adapter/A 


Proteon 4, 16, or 4/16 Mbps Token-Ring Adapter 
Madge 4, 16, or 4/16 Mbps Token-Ring Adapter 


Any Ethernet adapter supported by the IBM LAN 
Support Program 


TN3270 Any token-ring or Ethernet adapter that is 
supported by an FTP (version 2.05pl4 or newer), 
Novell LAN WorkPlace, Wollongong Pathway 
Access, Walker Richer & Quinn, Winsock 1.1 
compatible stacks, Sun PC-NFS, or Microsoft LAN 
Manager, 3Com, DC PATHWORKS 4.1 or newer 
TCP/IP protocol stack, Frontier Super 
TCP/NFS 
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Table 2-5 lists the maximum number of adapters supported. 


Table 2-5. Maximum number of adapters and connections 
supported by Irma 


Maximum 
number of Connections per 
Connection type adapters adapter 
DFT 1 1 
Token-ring 1 4 
sea SDLC 1 4* 
X.25 1 4 


You can configure four connections per link service for SDLC only when 
configuring multipoint connections where Irma is the primary station for APPC 
only. 


Software requirements 


Before you install Irma, you must install the following on your system: 


* One of the following: 
- Microsoft Windows version 3.1 or newer. 
or 
- Windows for Workgroups 3.11. 


¢ If you want to use PT/Express to transfer files, your host application 
(available from DCA) must be version 2.0 or newer. 


¢ If you want to use LU 6.2, you must have VTAM_ version 3.2, with NCP 
version 5.2 (3745 systems) or NCP version 4.3 (3725 systems). 
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° If you want to install Irma with a server connection, TN3270, or gateway 
connections, you also need to install the software as shown in Table 2-6. 


Table 2-6. 


Connection 
type 
ATLANTIS 
Gateway 


IrmaLAN for 
VINES Gateway 


IrmaLAN 
Gateway 


Netway 2000 
Gateway 
Digital SNA 
Gateway 


Eicon SNA 
Gateway 


Software requirements for mainframe connectivity 


Irma PC 

For DOS and OS/2 servers: 
Any LAN client software 
that uses NetBIOS. 

For UNIX servers: TCP/IP 


Banyan client software 
configured for NetBIOS, 
IPX/SPX 3.10 or newer, or 
VINES IP 4.1 or newer 


Any LAN client software 
configured for NetBIOS or 
NetWare IPX/SPX 3.10 or 
newer 


NetWare IPX/SPX 3.10 or 
newer 


PATHWORKS 4.1 or newer 


Any LAN client software 
configured for NetBIOS, 
IPX/SPX 3.10 or newer, or 
VINES IP 


The following files, provided 
by Eicon: 


. © NABIOS.EXE 


¢ NARDR.CMD (NetBIOS 
only) 

¢ NARDRSPX.CMD 
(IPX/SPX only) 

¢ ECLAN.EXE 


Gateway/server 
requirements 
ATLANTIS Gateway, 
8.00a or newer 
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IrmaLAN for VINES 
Gateway, 3.0.7 or newer 


DCA IrmaLAN, 3.0 or 
newer 


DCA Netway 2000 
Gateway, 4.2 or newer 


Digital SNA Domain 
Gateway-ST 1.1 or 
newer, SNA Domain 
Gateway-CT 1.1 or 
newer, DECnet/SNA 
Gateway-ST 1.2 or 
newer, DECnet/SNA 
Gateway-CT 2.1 or 
newer, DEC SNA Peer 
Server 1.0 or newer 


Eicon SNA Gateway, 3.0 
release 1 or newer 
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Table 2-6. Software requirements for mainframe connectivity (cont.) 


Connection _ Gateway/server 
type Irma PC requirements 
Novell NetWare NetWare 3.11 or newer. NetWare 3.x, 4.x, or 
forSAA gateway Make sure you have the newer 

client following file versions: NetWare for SAA 


¢ IPX.COM 3.10 or newer. gateway 1.x or newer 
If you are installing Irma (for IPX) or 1.3B (for 
on a 486 PC, we TCP/IP) 
recommend that you run 
Chapter 2 the ODI driver, instead of 
WSGEN.EXE. 
e LSL.COM 3.22 or 
newer, or PXODI.COM 
1.2 or newer, if you are 
running the ODI driver. 
° NETX.COM 3.22 for PCs 
using conventional 
memory. 
¢ EMSNETX.EXE 3.22 or 
newer for PCs using 
expanded memory. 
¢ XMSNETX.EXE 3.22 or 
newer for PCs using 
extended memory. 


You can also use TCP/IP 
protocol 1.3b or newer. 


HP-UX LAN Manager client Hewlett-Packard 
SNAplus Server software 2.2 or newer, HP-UX 9.0 or newer, 
configured for TCP/IP. with HP STREAMS/UX 
for Series 700 and 800 
LAN Manager for HP 
9000 2.2 
HP-UX SNAplusLink 
2.0 or newer 
Microsoft SNA Windows NT 3.1 or 3.5 Microsoft Windows NT 
Server client configured for NetBEUI, Workstation 3.1 or 3.5; 
SPX/IPX, or TCP/IP or Microsoft Windows 
protocol. NT Server 3.1 or 3.5 
Microsoft SNA Server 
2.0 or 2.1 
Select Comm Microsoft LAN Manager 2.1 DCA Select Comm 
Server or newer; IBM LAN Server Server 1.2 or newer 


1.3, 2.0 or newer. 
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Table 2-6. Software requirements for mainframe connectivity (cont.) 


Connection Gateway/server 
type Irma PC requirements 
Winsock Windows socket Any SNAP-IX compliant 
TCP/IP specification 1.1. server software 
TN3270 One of the following TCP/IP One of the following: 
protocol-stacks: ® IBM 3172, 3745, or 
e FTP version 2.05pl4 or 8234 controller with 
newer Telnet Server on the 
¢ Novell LAN WorkPlace host Chaphirs 
® Wollongong Pathway ¢ OpenConnect Server 
Access Il 


¢ Walker Richer & Quinn °° MacData 6100 
¢ Microsoft LAN Manager, ° Interlink 
or 3Com ¢ Intel® 9770 
¢ DEC PATHWORKS 4.1. © any TN3270 
or newer compatible gateway 
¢ Sun PC-NFS 
¢ Winsock 1.1 compatible 
stacks 
¢ Frontier Super TCP/NFS 
version 4.00 


Upgrading from a previous version of a 
DCA product 


If you have previously installed a DCA product, you do not need to remove it 
before installing Irma. 


The Irma Setup program detects that the software exists, and uses the existing 
configuration information as the new default configuration. 


When you run the Irma Setup program, remember the following: 


¢ If you specify the same destination directory as the directory where the 
older software resides, the new files are copied over the older files. 


e If you specify a different destination directory from the directory where the 
older software resides, the older files are not deleted by the Setup program. 
If you want to delete the older files, you must do so manually. 


In addition, the Setup program prompts you to select which types of 
configuration files and profiles to save. For more information about the file 
types and their extensions, see “About the file types used by Irma” on 
page 1-15. 
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Using existing configuration files and profiles 


If you have a previous version of IRMA WorkStations for Windows installed, 
the Setup program will prompt you to select which types of configuration 
files and profiles to save. For more information about the file types and their 
extensions, see “About the file types used by Irma” on page 1-15. 


Installation checklists 


These installation checklists were designed to make the installation process 
easier for you. 
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Before you install Irma, you need to do the following: 


QO) Make backup copies of the diskettes containing the Irma software. 


Q) Make sure you have the required hardware. For more information, see 
“Hardware requirements” on page 2-3. 


) Make sure you have the correct versions of software installed. For 
more information, see “Software requirements” on page 2-6. 


) Determine the destination drive and directory for the Irma software. 
Drive and directory: 
QO) Decide which Install Type you want to use: 


___ Personal Copy, which installs Irma for a single user. 
___ Shared Access, which allows you to install Irma to a shared drive so that 
multiple users can access the same program files. 


O) Decide if you need to use Complete Installation or Custom 
Installation: 


__ Complete Installation installs all stand-alone connection types (except 
for X.25) and all gateway connection types. 

__ Custom Installation allows you to select connection types and 
applications to install. Use this option if you want to install a server 
connection or an X.25 stand-alone connection. Be sure to complete the 
“Additional checklists for Custom Installation” on page 2-13. 


Q) If you have a previous version of Irma installed, decide if you want to 
save the existing configuration files (For a complete list of file types, 
see “About the file types used by Irma” on page 1-15.): 


__._ yes 
no 
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LY Decide if you want the Setup program to automatically change the 
system files. If not, you must do this step manually. We recommend 
that you let the Setup program perform this step automatically. Your 
current system files will be backed up by the Setup program. 


__ yes 
__no 


Q) If you are going to install Irma Graphics, be sure you have the optional 
diskette labeled “Irma Graphics” available from DCA. For more 
information, see“Ordering optional software” on page 2-3. 
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Checklist for TN3270 connections 


Complete the following checklist for TN3270 connections: 


L) Install the LAN adapter in your PC. 


Q) Install the TCP/IP protocol software required for your controller, 
gateway or server. For more information, see “Software requirements” 
on page 2-6. 


LJ Make sure you can access the TN3270 network by typing the 
following command at a command prompt: 


PING host 


In this statement, host is the address of the TCP/IP host or the TCP/IP host 
name. 


This utility indicates whether or not data is being sent successfully over the 
TCP/IP network. 
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Checklist for standalone connections 


Complete the following checklist for standalone connections: 


Q) Install the communications adapter(s) you are going to use in your PC. 


Record all the hardware settings you select because you will need to enter 
the information when you configure your links. Note that not all adapters 
use all the following settings: 


Chapter 2 Interrupt 
DMA channel 
I/O Address 
I/O Base Address 
Memory Segment Address 
Driver name 


Caution _ lf the parameters you enter in the configurator do not match your 
hardware configuration, Irma may not operate correctly. 


Some communications adapters require that you install the drivers and 
reboot your PC so that the drivers are loaded before you can run the Irma 
Setup program. 


Q) If you are going to use X.25 as your standalone connection type, be 
sure you have the optional diskette labeled “Irma X.25 Support,” 
available from DCA. For more information, see“Ordering optional 
software” on page 2-3. 


Checklists for gateway or server connections 


Complete the following checklist for gateway or server connections: 


Q) Install the LAN adapter in your PC. 


C) Install the LAN client software required for your gateway or server 
connectivity. Configure your adapter to use the same protocol your 
gateway or server uses. For more information, see “Software 
requirements” on page 2-6. 


() Determine whether you have the necessary privileges to use the LAN 
resources, including the gateway or server communications 
capabilities. If you have questions, ask your LAN administrator. 
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Additional checklist for Eicon SNA Gateway 


Complete the following checklist for an Eicon SNA Gateway connection: 


Q) Install the DOS Workstation Communications Drivers that are 
included with the Eicon Gateway. For more information, refer to the 
documentation provided by Eicon. 


QO) The following files, provided by Eicon, should be copied to your PC 
into a directory that is in your search path: 


__ NABIOS.EXE 

__ NARDR.CMD (for NetBIOS only) 

__ NARDRSPX.CMD (for IPX/SPX only) 
__ECLAN.EXE 
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QO) If you are using a 386 or 486 in Enhanced mode, the following lines 
must be added to the SYSTEM.INI file under the [386Enh] section: 


device= [path] VNABIOS.386 
NAHEAPSIZE=nn 


[path] is the complete path to the directory in which your Eicon files 
reside, and nnis a numeric value. Usually, 45 should be an acceptable 
value. 


If the device statement is missing from the SYSTEM.INI file, a pop-up 
message is displayed stating that “NABIOS not loaded properly:100.” 


If the NAHEAPSIZE statement is missing from the SYSTEM.INI file, a pop- 
up message may be displayed stating that the value should be increased. 


Additional checklists for Custom Installation 


If you choose to install the mainframe connectivity using the Custom 
Installation, complete this checklist. 


(C) Decide what connection types you want to install. You can install any 
number of standalone and gateway connection types or you can install 
a single server connection type. 


Select one of the following server connection types: 


__ HP-UX SNAplus Server 

__ DCA Select Comm Server (Be sure to complete the “Additional 
checklist for Select Comm Server” on page 2-14.) 

__ Microsoft SNA Server 

__ Winsock TCP/IP client 
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Or, select any number of the following standalone and gateway connection 
types: 


__ LAN Attached (802.2) 

__ Multi-Session Coax (DFT) 

__ Remote (SDLC) 

__ Single Session (CUT) 

___X.25 Standalone (requires the options X.25 Connection diskette) 
___TN3270 over TCP/IP 

__ ATLANTIS Gateway 

__ DCA IrmaLAN for VINES Gateway 
__ DCA IrmaLAN NetBIOS Gateway 
__ DCA IrmaLAN NetWare Gateway 
__ DCA Netway 2000 

__ Digital SNA Gateway 

__ Eicon SNA Gateway 

__ Novell NetWare for SAA Gateway 
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() Decide which applications to install: 


__ APPC/CPI-C (supported only with DPT, SDLC, 802.2, Select Comm 
Server, and SNA Server) 

__ DOS HLLAPI redirector 

__ EHLLAPI 

__ LUA support (supported only with DFT, SDLC, 802.2, Select Comm 
Server, and SNA Server) 

__ Mainframe Display 

__ Online Help (You should install online help since it contains most of the 
information you need to configure, use, and customize Mainframe | 
Display.) 

__ QuickDDE 

__ WinHLLAPI 


Additional checklist for Select Comm Server 


If you want to install the mainframe connectivity with a Comm Server 
connection, you need the following information from your system 
administrator: 


(1 Determine the name of the Select Comm Server PC. 
Name of Comm Server PC: 


() Make sure you have read access privileges for the Comm Server 
\COMMSRY directory. See your system administrator for more 
information. 


QO) If you are running DOWNLOAD.EXE in your AUTOEXEC.BAT file, 
remove this statement and reboot your PC before you install Irma. 
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Summary 


In this chapter, you learned about the following: 


) The Irma package contents 
C) How to plan for your Irma installation 


QO) What hardware and software you need for each connectivity type 


) How to upgrade from previous DCA emulation products 
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You should also have completed your installation checklists for your specific 
connectivity types. Now turn to Chapter 3, “Installing Irma,” and follow the 
step-by-step instructions for installing Irma. 


Installing Irma 


e Running the Setup program 3-2 
° Installing a personal copy — 3-4 
e Installing for shared access 3-12 
¢ What the Setup program does 3-22 
¢ Running Setup after Irma is installed 3-22 
¢ Summary 3-24 
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In this chapter, you’ ll learn how to install 
Irma using either the Personal Copy or 
Shared Access installation types. This 
Task List chapter also tells you how to do a 
Complete Installation or a Custom 
2 a Complete your planning Installation. You’ll also learn what the 
rheekdiest Setup program does, and how to run the 
Setup program after Irma is installed. 
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Install Irma 


ren eresroue nee If you completed the installation 


On aurenie Coubec ooans checklists in Chapter 2, installing Irma will 
start a communications session 
be very easy. 


Customize your session 


You’ ll need about 15 minutes to complete 
the installation process. 
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Running the Setup program 


Be sure to have your completed installation checklists handy as you run the 
Setup program. 


Note Before running the Setup program, read the READTHIS.WRI file that is 
located on the Irma Setup diskette. It may contain additional information 
that you need before proceeding with the installation. 


To run the Setup program, follow these steps: 


1 Start Windows. 


2 Insert the diskette labeled Irma for the Mainframe Setup Disk 1 in any 
available disk drive on your PC. 


3 Choose Run from the Windows Program Manager File pull-down. 


4 Inthe Command Line edit box, enter the following command and press 


(Enter): 
drive\SETUP 
In this command, drive is the drive where you inserted the Setup disk. 


The Irma title screen is displayed. Then the DCA License Agreement is 
displayed. 


5 Read the DCA License Agreement using the scroll bar to view the text. 
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When you have finished reading the License Agreement, choose “I have 
read the entire license agreement and I agree.” The Irma Setup dialog box 
is displayed, as shown in Figure 3-1. 
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Figure 3-1. The Setup dialog box 


Do the following: 


To... Then... 


Change the default destination direction Choose Change Directory. Then use the 
Install Location dialog box to select the 
destination drive and directory. 


You can select from the drive list to set the 
installation directory; however, this process 
is Slow because the entire drive must be 
scanned. 


Change the host language (character set) Change Language. Then use the Language 
or to select CECP support dialog box to select the host language and 
select CECP support. 


8 Do one of the following: 


To... Then... 

Perform a complete installation with all Choose the Complete Installation button. 
connections* 

Perform a custom installation, which Choose the Custom Installation button. 


allows you to select the connections you 
want to install 


* 


This installation installs all mainframe gateways and standalone connection 
types (except for X.25 connectivity). To install a server connection type or 
X.25 connectivity, you must perform a custom installation. 


9 Do one of the following: 


To... Then... 
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and read the next section “Installing a 
personal copy.” 


Installing a personal copy 


Continue reading this section if you chose Personal Copy as the Install type. 
Read either “Complete Installation” or “Custom Installation,” depending on 
the selection you made earlier in the Setup program. 


Complete installation 


Continue reading this section 1f you chose Complete Installation. 


1 Do one of the following: 


If... Then... 

The Setup program detects The Save Configuration Files dialog box 
that you already have a is displayed as shown in Figure 3-2. 
version of Irma installed. Continue with the next step. 


The Setup program does not Skip to step 3. 
detect that you already have 
a version of Irma installed. 
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Install the software for a single user Choose Personal Copy as the install type, 


Don't Save 


Chapter 3 


Figure 3-2. The Save Configuration Files dialog box 


2 Do one of the following: 


Choose this option... To... - 
Save Save the selected configuration files to a 


temporary directory. 
Don’t Save Not save any of your previous 
configuration files. 


3  Atthis point, the Irma files are copied to the destination directory. You are 
prompted to remove each diskette from the drive and insert the next 
diskette. | 


Note You can stop the installation process at any time by choosing 
Cancel. 


When the files have completed copying, the Group Box dialog box is 
displayed. 


4 Do one of the following: 


Select this option... To... 


User Defined Create a new program group containing 
the Irma icons. 


Any program group from Add the Irma icons to an existing program 
the list box group. 


5 Choose OK. 


6 If you selected User Defined, the Name Group Box dialog box is 
displayed. Enter the new group box name and choose OK. You are 
returned to the-Group Box dialog box. Then choose OK. 


The Update System Files dialog box is displayed, as shown in Figure 3-3. 


1PATH C-(ANOS:C-\w 

4 path=C:VIRMA\3270:2path 

4 C:\DOS\SHARE.EXE /1:500 /f:5100 
1 PROMPT $P$G 
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Figure 3-3. The Update System Files dialog box 


7 Do one of the following: 


Choose this option... To... 

Make Changes Automatically change the system files 
AUTOEXEC.BAT, WIN.INI, and 
SYSTEM.INI. 


Save Changes as *.[.WW _ Save the changes to a separate file. You 
must incorporate the changes to the 
individual files manually. The dialog box 
displays recommended changes to the 
AUTOEXEC.BAT file and allows you to 
edit the file. Use the Undo button to undo 
incorrect changes. Once Setup has edited 
the files, it displays the message “Changes 
have been made” and shows you where it 
stores the original files. 


Abandon All Changes Cancel the Setup program. 


Restart Setup Return to the first screen of the Setup 
program. 


If you had a previous version of Irma installed, and you selected to save 
your configuration files, a Setup dialog box is displayed asking 1f you want 
to restore those files from the temporary directory to the new Irma 
directory. 


8 Do one of the following: 
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Yes Move all the saved configuration files 
from the temporary directory to the Irma 
directory. 

No Keep all the saved configuration files in 


the temporary directory. You can 
manually move them to the Irma 
directory at a later time. 


The Setup Complete dialog box is displayed. 


9 Do one of the following: 


Choose this option, | Toe ala 
Restart PC Now Close all your applications and restart 

Windows. 
Do Not Restart Continue working with Windows; 

however, you must restart Windows 

before using Irma. 


At this point, the installation is complete. You can skip the next section, and 
turn to “What the Setup program does” on page 3-22. 


Custom Installation 


Continue reading this section if you chose Custom Installation. 


At this point, the Connections dialog box is displayed as shown in Figure 3-4. 
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TN3270 over TCP/IP 


X.25 Standalone Remave All 


Figure 3-4. The Connections dialog box 


The following table describes the options on the Connections dialog box. 


Choose this option... To... 


Standalone or Gateway Display the standalone and gateway 
connection types in the Connections 
Chosen list box. 


Server Connections Display the server connection types in the 
Connections Available list box. 


Add Move the highlighted connection type 
from the Connection Available list box to 
the Connections Chosen list box. 


Remove Move the highlighted connection type 
from the Connections Chosen list box to 
the Connections Available list box. 


Add All Move all connection types from the 
Connections Available list box to the 
Connections Chosen list box. 


Remove All | Move all connection types to the from the 
Connections Chosen list box to the 
Connections Available list box. 


Note You must choose at least one connection type. 
Follow these steps: 


1 Once you have selected your desired connections, choose OK. The 
Applications dialog box is displayed as shown in Figure 3-5. 


Mainframe Display 


Reomaye 
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Remove All : 


Cancel | 


Figure 3-5. The Applications dialog box 


The following table describes the options on the Applications dialog box. 


Choose this option... To... 
Add Move the highlighted application from 


the Applications Available list box to the 
Applications Chosen list box. 


Remove Move the highlighted application from 
the Applications Chosen list box to the 
Applications Available list box. 


Add All Move all applications from the Appli- 
cations Available list box to the 
Applications Chosen list box. 


Remove All Move all applications from the Appli- 
cations Chosen list box to the 
Applications Available list box. 


Note You must choose atleast one application to install. 


2 Once you have selected your desired applications, choose OK. 
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3 Do one of the following: 


If... Then... 

The Setup program detects The Save Configuration Files dialog box 
that you already have a is displayed as shown in Figure 3-6. 
version of Irma installed. Continue with the next step. 


The Setup program does not Skip to step 5. 
detect that you already have 
a version of Irma installed. 
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Don't Save 


Figure 3-6. The Save Configuration Files dialog box 


4 Do one of the following: 


Choose this option... To... 


Save Save the selected configuration files to a 
temporary directory. 


Don’t Save Not save any of your previous 
configuration files. 


5 At this point, the Irma files are copied to the destination directory. You are 
prompted to remove each diskette from the drive and insert the next 
diskette. 


Note You can stop the installation process at any time by choosing 
Cancel. 


When the files have completed copying, the Update System Files dialog 
box is displayed, as shown in Figure 3-7. 


6 


Update Systent Flic 


PATH C\DOS:C \WINDOWS: 

path-C:\IRMA\32/U:%path% 

C:\DOS\SHARE.EXE /1:500 /f:5100 
3G 


ATH C:\DOS:C:\ WINDOWS: 
path-C:\IRMA\3270:%path% 
path=C_\IRMA\5250. “path 
(\DOS\SHARE FXE /1-500 s/f 5100 


adi 


Larredar 


Figure 3-7. The Update System Files dialog box 


Do one of the following: 


Choose this option... 
Make Changes 


Save Changes as *. [WW 


Abandon All Changes 


Restart Setup 


To... 


Automatically change the system files 
AUTOEXEC.BAT, WIN.INI, and 
SYSTEM.INI. 


Save the changes to a separate file. You 
must incorporate the changes to the 
individual files manually. The dialog box 
displays recommended changes to the 
AUTOEXEC.BAT file and allows you to 
edit the file. Use the Undo button to undo 
incorrect changes. Once Setup has edited 
the files, it displays the message “Changes 
have been made” and shows you where it 
stores the original files. 


Cancel the Setup program. 


Return to the first screen of the Setup 
program. 


If you had a previous version of Irma installed, and you selected to save 
your configuration files, a Setup dialog box is displayed asking if you want 
to restore those files from the temporary directory to the new Irma 


directory. 
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7 Doone of the following: 


Se i nl ds cs 

Yes Move all the saved configuration files 
from the temporary directory to the Irma 
directory. 

No Keep all the saved configuration files in 


the temporary directory. You can 
manually move them to the Irma 
directory at a later time. 


The Setup Complete dialog box is displayed. 


8 Do one of the following: 


Choose this option... To... 

Restart PC Now Close all your applications and restart 
Windows. 

Do Not Restart Continue working with Windows; 


however, you must restart Windows 
before using Irma. 


At this point, the installation is complete. You can skip the next section, and 
turn to “What the Setup program does” on page 3-22. 


Installing for shared access 


Continue reading this section if you chose Shared Access as the Install type. 
Read either “Complete Installation” or “Custom Installation,” depending on 
the selection you made earlier in the Setup program. 


Complete installation 


Continue reading this section if you chose Complete Installation. 


1 Do one of the following: 


If... Then... 

The Setup program detects The Save Configuration Files dialog box 
that you already have a is displayed as shown in Figure 3-8. 
version of Irma installed. Continue with the next step. 


The Setup program does not Skip to step 3. 
detect that you already have 
a version of Irma installed. 
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Don't Save 
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Figure 3-8. The Save Configuration Files dialog box 


Do one of the following: 


Choose this option... To... 
Save Save the selected configuration files. 
Don’t Save Not save any of your previous 


configuration files. 


At this point, the Irma files are copied to the destination directory. You are 
prompted to remove each diskette from the drive and insert the next 
diskette. 


Note You can stop the installation process at any time by choosing 
Cancel. 


If you had a previous version of Irma installed, and you selected to save 
your configuration files, a Setup dialog box is displayed asking if you want 
to restore those files from the temporary directory to the new Irma 
directory. 


Do one of the following: 


Choose this option... To... 

Yes Move all the saved configuration files 
from the temporary directory to the Irma 
directory. 

No Keep all the saved configuration files in 


the temporary directory. You can 
manually move them to the Irma 
directory at a later time. 


The Setup dialog box is displayed, as shown in Figure 3-9. 


Setup has completed the shared access installation. To setup this 
workstation or any additional client workstations, run the setup 
program from the installation directory. 


Figure 3-9. The Setup dialog box 


5 Choose OK. At this point, the installation is complete. 


Now you are ready to run the Setup program from each workstation. For 
Chapter 3 instructions on installing to each workstation, skip to “Attaching a 
workstation to a shared installation” on page 3-18. 


Custom installation 


Continue reading this section if you chose Custom Installation. 


At this point, the Connections dialog box is displayed as shown in 
Figure 3-10. 


Atlantis Gateway | 


rmaLAN for VINES Gateway 
rmaLAN Netbios Gateway 
rmaLAN NetWare Gateway 


TN3270 over TCP/IP 
x25 Standalone 


Cancel 


Figure 3-10. The Connections dialog box 


a 


f. m a ” oe 
3-14 bye gedoitiovsres tear gehts reat Ly of fete te be 
EELER ELE IS Fe Fh o4fe EGE eee BUCEES 
“er 


The following table describes the options on the Connections dialog box. 


Choose this option... To... 


Standalone or Gateway Display the standalone and gateway 
connection types in the Connections 
Chosen list box. 


Server Connections Display the server connection types in the 
Connections Available list box. 


Add Move the highlighted connection type 
from the Connection Available list box to 
the Connections Chosen list box. 


Remove Move the highlighted connection type 
from the Connections Chosen list box to 
the Connections Available list box. 
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Add All Move all connection types from the Con- 
nections Available list box to the Connec- 
tions Chosen list box. 


Remove All Move all connection types from the Con- 
| nections Chosen list box to the Connec- 
tions Available list box. 


Note You must choose at least one connection type. 
Follow these steps: 


1 Once you have selected your desired connections, choose OK. The 
Applications dialog box is displayed as shown in Figure 3-11. 


Mainframe Display 


Add All 


Cancel 


Figure 3-11. The Applications dialog box 
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The following table describes the options on the Applications dialog box. 


Choose this option... To... 


Add Move the highlighted application from 
the Applications Available list box to the 
Applications Chosen list box. 


Remove Move the highlighted application from 
the Applications Chosen list box to the 
Applications Available list box. 


Add All Move all applications from the 
Applications Available list box to the 
Applications Chosen list box. 


Remove All Move all applications from the 
Applications Chosen list box to the 
Applications Available list box. 
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Note You must choose at least one application to install. 
2 Once you have selected your desired applications, choose OK. 


3 Do one of the following: 


If... Then... 

The Setup program detects The Save Configuration Files dialog box 
that you already have a is displayed as shown in Figure 3-12. 
version of Irma installed Continue with the next step. 


The Setup program does not Skip to step 5. 
detect that you already have 
a version of Irma installed 


Don't Save 
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Figure 3-12. The Save Configuration Files dialog box 


Do one of the following: 


Choose this option... TO. * 
Save Save the selected configuration files. 
Don’t Save Not save any of your previous 


configuration files. 


At this point, the Irma files are copied to the destination directory. You are 
prompted to remove each diskette from the drive and insert the next 
diskette. 


Note You can stop the installation process at any time by choosing 
Cancel. 


If you had a previous version of Irma installed, and you selected to save 
your configuration files, a Setup dialog box is displayed asking if you want 
to restore those files from the temporary directory to the new Irma 
directory. 


Do one of the following: 


Choose this option... To... 

Yes Move all the saved configuration files 
from the temporary directory to the Irma 
directory. 

No Keep all the saved configuration files in 


the temporary directory. You can 
manually move them to the Irma 
directory at a later time. 
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The Setup dialog box is displayed, as shown in Figure 3-13. 


Setup has completed the shared access installation. To setup this 
workstation or any additional client workstations, run the setup 
program from the installation directory. 


Figure 3-13. The Setup dialog box 


7 Choose OK. At this point, the installation is complete. 


Now you are ready to run the Setup program from each workstation. For 
Chapter 3 instructions on installing to each workstation, read the next section, 
“Attaching a workstation to a shared installation.” 


Attaching a workstation to a shared 
installation 


To attach a workstation to the Irma shared installation, follow these steps: 


1 From the workstation that you want to attach, use the Windows File 
Manager and choose the file SETUP.EXE located in the Irma installation 
directory. 


The Irma title screen is displayed. Then the DCA License Agreement is 
displayed. 


2 Read the DCA License Agreement, using the scroll bar to view the text. 
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3 When you have finished reading the License Agreement, choose” I have 
read the entire license agreement and I agree.” The Welcome dialog box is 


displayed, as shown in Figure 3-14. 
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Figure 3-14. The Welcome dialog box 


4 Choose Attach to Software. The Set Private Directory dialog box is 
displayed, as shown in Figure 3-15. 


"Set Private Di 


Figure 3-15. The Set Private Directory dialog box 


5 Specify the private path and choose OK. 


6 At this point, the Irma files are copied to the destination directory. You are 
prompted to remove each diskette from the drive and insert the next 


diskette. 


Note You can stop the installation process at any time by choosing 
Cancel. 


When the files have completed copying, the Group Box dialog box is 
displayed. 


7 Doone of the following: 


Select this option... To... 


User Defined Create a new program group containing 
the Irma icons. 


Any program group from Add the Irma icons to an existing program 
the list box group. 


8 Choose OK. 
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9 If you selected User Defined, the Name Group Box dialog box is 
displayed. Enter the new group box name and choose OK. You are 
returned to the Group Box dialog box. Then, choose OK. 


The Update System Files dialog box is displayed, as shown in Figure 3-16. 


PATH C:\DOS:C:\WINDOWS: 
path=C:\IRMA\32 /0:~path 
C:’'\DOS\SHARE.EXE /1:500 /f:5100 
PROMPT 8P38G 


PATH C:\DOS:C:\WINDOWS: 
poth=C:\IRMA\3270:%path™ 
path=C:\IRMA\5250:%path% 
CA\DOS\SHARE_ EXE /1:500 /f:510 iis 
¥E<7E3 


Figure 3-16. The Update System Files dialog box 
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10 Do one of the following: 


Choose this option... To... 
Make Changes Automatically change the system files 
AUTOEXEC.BAT, WIN.INI, and 


SYSTEM.INI. We recommend that you 
allow the Setup program make this 
changes for you. 


Save Changes as *.IWW Save the changes to a separate file. You 
must incorporate the changes to the 
individual files manually. The dialog box 
displays recommended changes to the 
AUTOEXEC.BAT file and allows you to 
edit the file. Use the Undo button to undo 
incorrect changes. Once Setup has edited 
the files, it displays the message “Changes Chapter 3 
have been made” and shows you where it 
stores the original files. 


Abandon All Changes Cancel the Setup program. 


Restart Setup Returns to the first screen of the Setup 
program. 


The Setup Complete dialog box is displayed. 


11. Do one of the following: 


Choose this option... To... 

Restart PC Now Close all your applications and restart 
Windows. 

Do Not Restart Continue working with Windows; 
however, you must restart Windows 
before using Irma. 


At this point, the installation is complete. Continue reading the next section, 
“What the Setup program does.” 
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What the Setup program does 


When you install Irma, the Setup program performs the following tasks: 


¢ Copies the Irma files and directories to the destination directory 
¢ Creates a program group containing the Irma application icons 


¢ If you chose to have the Setup program automatically update your system 
files, the following changes are made: 


- The \irma directory is added to the path statement of your 
AUTOEXEC.BAT, where irma is the destination directory you 
specified 


- The following lines are added to your WIN_INI file: 
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[IrmaWorkStation] 
defaultpath=drive: \path\3270 
Como leteRUs=NO 
UsePrintRSHUTD=NO 


¢ If you had a previous version of Irma installed, and you chose to save your 
configuration files, a temporary directory named \IWWCEFG is created, and 
those selected files are copied to that directory. At the end of the Setup 
program, if you select to restore your configuration files, the files are 
moved from the temporary directory to the Irma installation directory. 


Running Setup after Irma is installed 


After you initially install Irma, you may need to run the Setup program again. 
The options available to you depend on whether you installed Irma as a 
personal copy or as a shared access installation. 


Ys 4 bhnee Korhonen 44 pe SOE OEE we ht ts, obs, £0 

4 BE £E PEE EAE Ga BAe Re ee tile Bee OSC Bo BO 

3-22 Uehet the SOLU DPOUGTAIN Fae8 
tabs 


bee teh sob fh bum pen Forceraes 04, 
SEGLALAISIETED BETEIA 
: 


Personal copy 


If you installed Irma as a personal copy, you can run the Setup program to do 
the following: 


View the ReadThis.WRI file 
Add connections or applications 
Install an option disk 

Change the host language 


Deinstall Irma 


Set up other options including: 
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- Update system files 

- Change the name of the Irma program group 
- Save configuration files 

- View current setup 


- Install keyboard driver 


To run the Setup program, choose the Setup icon from the Irma program 
group, and then choose the option that you want to change. 


Shared access 


If you installed Irma for shared access, you can run the Setup program to do 
the following: 


Update system files 

Change the name of the Irma program group 
Save configuration files 

View current setup 

Install keyboard driver 


Attach to the shared access installation 


To run the Setup program, choose the Setup icon from the Irma program 
group, and then choose the option that you want to change. 
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Summary 


In this chapter, you learned the following: 


QO How to install Irma using either the Personal Copy or the Shared 
Access installation types 


QO) What the Setup program does 


Q How you can run the Setup program after the initial installation 


Before you can use any of the installed connectivities, you must configure 
each connection. All the information about configuring, customizing, and 
using the Irma connectivities is contained in online help. Therefore, it is very 
important that you understand how the Irma online help works and how to 
find the information you need. 


Now turn to Chapter 4, “How Online Help Works,” to learn how to use the 
Irma online help. 
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How Online Help 
Works 


¢ Why use online help? 4-2 
¢ What if you’re new to online help? 4-2 
® How do you access online help? 4-5 
© Online help tutorial 4-6 
¢ Summary 4-9 


Chapter 4 


If you haven’t used online help 
before, don’t worry. This chapter 
will teach you how to access online 
Task List help from a dialog box and by using 
the Help menu. You’ll also learn how 
to use each of the Help buttons and 
how to search for a topic. 


Even if you’re familiar with using 
Learn about online help online help in other products, take a 
Contigure the connection and few minutes to scan this chapter so 
start a communications session you'll] understand how the Irma 


Customize your session online help works. 


You'll need about 15 minutes to 
read this chapter and complete the 
online help tutorial. 


cnpter4 Why use online help? 


It is very important that you are comfortable working with the Irma online 
help because it contains the information you need to configure, use, and 
customize Irma. 


What if you’re new to online help? 


If you haven’t used online help before, take a few minutes to become familiar 
with the features described in this section. 


When you access online help, you’ll see a window similar to the one in 
Figure 4-1. 
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Figure 4-1. Example of a Help window 


Table 4-1 describes the Help window features. 


Table 4-1. Help window features 


Feature Example Description 

Jumps The status line When you see text that is underlined 
with a solid line, it means that the text 
is linked to another piece of 
information. When you move the 
pointer over the underlined text, the 
pointer changes to a pointing hand. 
Click once on the underlined text to 
“jump” to the related information. To 
move back to the original help topic, 
choose Back from the button bar. 
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Table 4-1. Help window features (cont.) 


Feature Example Description 
Popup Mainframe Dispiay.When you see text that is underlined 
boxes with a dotted line, it means that the text 


is linked to another piece of 
information. When you move the 
pointer over the underlined text, the 
pointer changes to a pointing hand. 
Click once on the underlined text to 
displayed a pop-up box containing the 
related information. To close the pop- 
up box, click once anywhere on the 


screen. 

Contents This button displays the help contents 

button for the application. This contents page 
is organized much like a table of 
contents in a book. If you’re new to an 
application, you can start with 
“Introducing” and move on to the other 

Chapter 4 major topics, just as you would move 

through a book. 

Search This button displays the Search dialog 

button box, which allows you to search for 
keywords in the online help. 

Back This button takes you back to the 

button previous help panel. 

History This button displays the names of the 

button help panels in the order in which you 
have accessed them. 

Glossary This button displays a glossary of 

button terms used in the application. 

Support This button displays a Write file 

button containing information about 


contacting DCA Technical Services. 


For complete information about using Windows online help, including how to 
print help panels, do the following: 


¢ Choose Using Windows Help from the Help menu of any window. 
or 

* Open any Help window and press (F1_]. 
or 


¢ Open any Help window and choose Using Help from the Help menu. 
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How do you access online help? 


Table 4-2 explains the two ways to access online help. 
Table 4-2. Ways to access online help 


You can access online 


help by... The information you see is... 
Clicking on the Help Detailed information about the dialog 


button in a dialog box. —_ box, including information for each 
entry field or selection. 


Choosing Help from Help that is organized much like a 

the menu bar. book, including a contents panel. You 
can search the entire help file for the 
information you want. The help file 
also includes a glossary. 


Once you have accessed online help, you can resize, move, maximize, and 
minimize the Help window, just as you can any other window. If you see a 
scroll bar on the right side of the Help window, be sure to scroll down to see _—_ Chapter 4 
all the information for a help topic. 


The following sections explain how to access online help using both methods. 


Choosing the Help button from a dialog box 


Most dialog boxes that require you to enter information or to make choices 
contain a Help button. For assistance with completing the fields or making 
selections, simply click the Help button. The Help window is displayed with 
information about the dialog box, including the entry fields and other 
selections. 


To close the Help window, choose Exit from the File menu. 
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Choosing help from the menu bar 


You can access online help anytime by choosing one of the topics from the 
Help menu. The menu selections are described in Table 4-3. 


Table 4-3. Help menu selections 


Selection Description 

Help for application This selection opens the Help window and 
displays a panel that introduces the 
application. 

Using Windows heip This selection opens the Help window and 


displays general information about how to 
use online help. 


Contents This selection opens the Help window and 
displays the contents panel for the 
application’s online help. 
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Online help tutorial 


Follow these steps to learn how to access, search, and navigate through the 
Irma online help. 


Lesson 1: Using the Help button in a dialog 
box 


1 Start the Mainframe Sessions application by choosing the Mainframe 
Sessions icon. You don’t need to activate a host session to complete the 
online help tutorial. 


2 Choose Preferences from the Settings menu. The Preferences dialog box 
is displayed. 


3 Click the Help button. The Help window is opened, and it displays 
information about the Preferences dialog box. 


Y You just accessed online help using a dialog box Help button. 


4 If necessary, use the scroll bars so that you can see the Related Topics at 
the bottom on the help panel. 


5 Click the green text “Using shortcut keys” to jump to information about 
shortcut keys. 


VY You just learned how to “jump” from one topic to another. 
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6 Close the Help window by choosing Exit from the File menu. 


7 


Choose Cancel to close the Preferences dialog box. 


Lesson 2: Using the Help menu option 


1 


10 


12 


13 


Choose Help for Mainframe Display from the Help menu. The Help 
window is opened, and it displays the help topic “Introducing Mainframe 
Display.” 


VY You just accessed online help using the Help menu. 


Click the text “Mainframe Display menus.” A pop-up box displays a list 
of jumps. 


To close the pop-up box, click anywhere on the screen. 


Y You just learned how to display and close a pop-up box. 


Choose Contents from the button bar. The help topic “Help Contents for 
Mainframe Display” is displayed. Chapter 4 


Y You just learned how to navigate to the Contents panel. 


Click the text “Getting Started.” The “Getting Started” help topic is 
displayed. 


Click the text “Selecting your connection.” The “Selecting your 
connection” help topic is displayed. 


Choose Back from the button bar. The previous help topic (“Getting 
Started’’) is displayed. 


Choose Back from the button bar. The previous help topic (“Help Contents 
for Mainframe Display’’) is displayed. 


Y You just learned how to display previous panels using the Back button. 
Choose Search from the button bar. The Search dialog box is displayed. 


Enter the word “QuickBar.” As you type, the upper list box displays 
keywords that match what you are entering. 


When the word “QuickBar’ is highlighted, click Show Topics. A list of 
related topics is displayed in the lower list box. 


Select “Customizing your QuickBar,” and click Go To. The “Customizing 
your QuickBar’” topic is displayed. 


VY You just learned how to find a help topic using the search feature. 


Close the Help window by choosing Exit from the File menu. 
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Lesson 3: Using the Glossary and Support 
buttons 


1 Choose Contents from the Help menu. 


2 Choose Glossary from the button Bar. The Glossary window is opened, 
and it displays the glossary contents. 


3 Click the letter “L.” The contents list scrolls to the letter L. 


4 Scroll down until you see the text “LU” and click the text. A definition for 
LU is displayed in a pop-up box. 


5 Toclose the pop-up box, click anywhere on the screen. 


6 Toclose the Glossary window, choose Close from the Control menu (the 
left-most icon in the title bar). 


Y You just learned how to use the glossary feature. 


7 If you have a question, and you cannot find the answer in this guide or in 
Chapter 4 the online help, you may want to contact DCA Technical Services. To find 
out more information about troubleshooting and contacting Technical 
Services, choose Support from the button bar. A Write file is displayed 
with information about troubleshooting and contacting Technical 
Services. 


Note You can also you can refer to Appendix A, “Troubleshooting,” for 
information about contacting DCA Technical Services. 


8 Toclose the Write window, choose Exit from the File menu. 


Y You just learned how to access troubleshooting and Technical Services 
information. 


That’s all there is to using the Irma online help. You should now feel 


comfortable in accessing the information you need to configure, use, and 
customize Irma. 


Gun th yy ge Page bire, Gs chars vd tek 
4-8 Chiiding hele tuterial 


Summary 


In this chapter, you learned the following: 


QO) How to access online help from a dialog box and the Help menu 
CL) What each of the Help buttons does 


() How to search the online help for a keyword 


Now that you know how to use the Irma online help, turn to Chapter 5, 
“Finishing Up the Task List,” which tells you where to go from here to 
complete the remaining tasks on the task list. 
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Finishing Up the 
Task List 


°® Configuring the connection and starting a 


communications session 5-2 
¢ Customizing your session 5-6 
° Developing your own applications 5-6 
¢ Summary 5-7 


Chapter 5 


In this chapter, you’ ll complete Task 5, 


: “Configuring the connection and starting a 
. communication session.” This chapter 
Task List also tells you how to get additional 


Pena aeats information from online help to assist you 
with Task 6, “Customizing your session.” 
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In addition, this chapter describes the 
application tools available for Irma. 
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You’ ll need about 10 minutes to read this 
and start a communications chapter. 


session 
Customize your session 


Configuring the connection and_ 
starting a communications session 


Task 5 on the Task List is “Configure the connection and start a 
MEPIS communications session.” This section explains how to do this task. 


To configure a mainframe connection, follow these steps: 


1 Start the Mainframe Sessions application by clicking the Mainframe 
Sessions icon. The Select Connection dialog box is displayed. 


As an example, a Select Connection dialog box with only the 802.2 
connection installed is shown in Figure 5-1. 
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Figure 5-1. The Select Connection dialog box 


Select the connection type you want to use and choose Select. The 
Configuration Options dialog box is displayed as shown in Figure 5-2. 
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Figure 5-2. The Configuration Options 
dialog box 


Choose Connection. A Connection dialog box is displayed with entry 
fields for the selected connection type. For assistance with completing this 
dialog box, click Help. 


As an example, the Token-Ring Connection dialog box is shown in 
Figure 5-3. 
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Token Ring Connection 
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@ Primary 


Delete... 


Connection Name: 


Description: 


Node ID to Send: 05D | jFFFFF 


TF 


Node ID to Receive: XID Type-; 


Destination Address: | oooooo000000 ™ Format 0 


Remote SAP Address: [4 ® Format 3 


Figure 5-3. The Token Ring Connection dialog box 


4 Some connection types have additional dialog boxes that are accessed by 
choosing buttons on the Connection dialog box. Be sure to enter the 
required information in all the dialog boxes. 


For example, the Token-Ring Connection dialog box, shown in 
Figure 5-3, has two buttons named Framing and SNA. If you click either 
of these buttons, another dialog box is displayed. 
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5 When you have entered all the information in the Connection dialog 
box(es), choose OK. The Select Connection dialog box is displayed. 


6 Choose Select to make the newly configured connection the active 
connection. The Start Sessions dialog box is displayed, as shown in 
Figure 5-4. 


Start Sessions | 


session ID and Description 


B - Token Ring Session B 
C - Token Ring Session C 
D - Token Ring Session D 


pslanup Display Types 


® Mod 2 C: Mod 3 {> Mod 4 
x Auto Connect Session Startup Script: | | 


Cancel 


Figure 5-4. The Start Sessions dialog box 


7 Select the Session you want to start and the Startup Display Type. If 
desired, choose Auto Connect Session and specify a Startup Script. 


8 Choose Start to start the session. 
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Customizing your session 


Task 6 on the Task List is “Customize your session.” All the information you 
need to do this task is contained in the online help. 


To find the information you want: 


1 Choose Contents from the Help menu. The Help window is opened, and it 
displays the “Contents” topic. 


2 Do one of the following: 


To... Do this... 


See a list of related topics Choose the Topic “Using the application,” 
where application refers to the application 
you are currently running. 


Search for a topic Choose Search from the button bar and 
search for a topic based on a keyword. 


Refer to Chapter 4, “How Online Help Works,” for assistance with using 
online help. 


cps Developing your own applications 


As you use Irma, you may decide that you want to automate common tasks. 
There are several tools that can help you develop your own applications that 
work with Irma. Each tool is described in Table 5-1. 


Table 5-1. Development tools 


Development 

tool Description 

Standard Irma __Irma offers enhanced scripting capabilities with the 
Script Standard Irma Script Language (SISL). For example, 
Language you can use SISL to automate file transfers, start and 
(SISL) control applications, access a mainframe database, and 


retrieve and move information. You use the QuickScript 
application that is included with Irma to create, edit, 
compile, and run the SISL scripts. 


Full support for SISL is included in the Mainframe 
Sessions application. Instructions for using SISL and 
QuickScript are contained in the QuickScript online help. 
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Table 5-1. Development tools (cont.) 


Development 


tool Description 
QuickApp™ for DCA offers a product, QuickApp for Windows, that is a 
Windows middle-ware communications development tool for 


developing client/server applications. QuickApp requires 
Visual Basic™, Visual C++™, PowerBuilder™, 
SQLWindows®, or ObjectView®. You can use QuickApp 
with Irma to develop graphical front-end interfaces for 
legacy host applications. 


For more information, or to order QuickApp for Windows, 
contact DCA Sales Operations at 1-800-348-3221. 


Distributed To develop your own applications using APPC, CPI-C. 
Applications LUA, or CSV, you must have this tool kit. 
Epvelopel : To order the tool kit, call Developer Services at (404) 
moot t 740-0001 
HLLAPI To develop your own applications using HLLAPI, you 
Software must have this tool kit. 
Eevelpel ? To order the tool kit, call Developer Services at (404) 
teens 740-0001 
Summary Chapter 5 


In this chapter, you learned the following: 


OY How to configure a connection and start a session 
L} Where you can find information to help you customize your sessions 


L} The development tools available for Irma 


We hope you found this Getting Started Guide to be helpful. We welcome 
your comments so that we can continue to improve our documentation. Please 
use the Comment Card located in the back of this guide to give us your ideas 
and suggestions. 


There are also electronic Comment Cards included in the online help for each 
application. Choose “What Do You Think” from the Contents panel to access 
the online Comment Card. 


Troubleshooting 


® General troubleshooting procedures A-2 
® Contacting Technical Support A-2 
¢ Technical support information sheet A-8 
° Obtaining product upgrades A-9 
e Replacing software disks A-9 
¢ Returning hardware or software A-10 
¢ DCA return form A-13 
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General troubleshooting procedures 


If you have problems running your Irma software, complete the following 
steps: 


Appendix A 1 Check to see that your system meets the minimum hardware and 
software requirements necessary to use the product. Refer to the 
hardware and software requirements earlier in this guide for this 
information. 


2 Check the configuration options. Most problems are caused by incorrect 
software configuration. Check to make sure you have selected the correct 
configuration options. 


3 Check your connections. Check your cable connections and make sure 
that they are securely attached. 


4 Check your system. You may be using peripheral equipment or other 
software that may not be compatible with this product. Try disabling some 
of the other memory-resident programs. 


5 Resolve errors. If you are receiving error messages, click Troubleshoot- 
ing from the Help Contents for help resolving these messages. 


6 Check the DCA BBS. Check the DCA BBS for tech tips or hot fixes that 
may solve your problem. 


7 Consult your distributor. If you cannot identify and solve the problem 
without assistance, contact your product distributor. Call from a location 
where you have access to the problem PC. 


8 Contact DCA technical support. Refer to the following sections, 
"Contacting Technical Support" and "Technical Support Information 
Sheet," for more information. 


Contacting Technical Support 


Every product package that you purchase from DCA comes with a Standard 
level of technical support as a part of our SupportWorks technical services 
program. SupportWorks Standard provides access to technical support 
through our Technical Services Group (TSG) by phone or through electronic 
means. 


Note The Standard SupportWorks program offerings vary from country to country. 
’ The information provided here is for the United States and Canada. For 
international Support Services, contact your local DCA distributor, DCA 
account representative, or TSG for details. 
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Phone access for registered users 


In the United States and Canada, SupportWorks Standard support provides 
the following phone service to registered users from 9 A.M. to 8 P.M. Eastern 
Time, Monday through Friday, excluding DCA holidays: 


¢ Complimentary technical support from DCA for 90 days calculated from 
the day of your first call 


Note After the 90 days have expired, you can call TSG for a minimal 
fee, which will be applied to your credit card (Master Card, VISA, 
or American Express). 


¢ An estimated 4-hour response time from a technical support analyst 


Note The SupportWorks offerings vary from country to country. The 
information provided here is for the United States and Canada. For 
International Support Services, contact your local DCA distributor, 
DCA account representative, or TSG for details. 


Support hotlines 


Our support hotlines follow: 


United States, Canada, and Latin America (404) 740-0300 
Asia (65) 291-7988 

Australia (61) (2) 451-8255 

Europe +353 61-472111 

Japan (81) (3) 5275-0130 


Before you call 


Before contacting TSG by phone, complete the following items in 
preparation—it will help us to resolve your problem more quickly and 
efficiently. 


¢ If possible, when you call, be at the computer with the DCA product 
installed and connected, the computer on, and the software loaded. 


¢ Complete the "Technical Support Information Sheet" located in the 
following section. 
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Electronic access for registered users 


You can contact TSG electronically by fax, BBS, or public electronic mail 
services. DCA will endeavor to respond by the next business day to issues 
submitted electronically, and this service is available during and after your 
Appendix A standard 90 days of support service. 


FAX access 


The fax numbers are as follows: 


United States, Canada, and Latin America (404) 442-4358 
Asia (65) 291-9281 

Australia (61) (2) 451-4034 

Europe +353 61-474002 

Japan (81) (3) 5275-0755 


Using the "Technical Support Information Sheet," you can fax your question 
or problem directly to TSG. 


BBS access in the United States and Canada 
(404) 740-8428 


Registration on the DCA BBS is free. All you need is an asychronous modem 
and asynchronous communication software, such as DCA Crosstalk®. Set 
your communication software parameters for BBS access as follows: 


Seting 
e 
Pay [Nome 
Speed = ODerhigher 
Emulation [ANSIOPTIY 
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BBS access in Europe, Africa, and the Middle East 


353 61 474460 353 61 474246 
(If you have modem compatibility problems 
with the first number, try this number.) 
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Registration on the DCA BBS is free. All you need is an asychronous modem 
and asynchronous communication software, such as DCA Crosstalk. Set your 
communication software parameters for BBS access as follows: 


Parameter [Setting 
Pay [Noe 


If the following options are available in your asynchronous communications 
software, use these values: 


[Spiion “(Vas 


Using the DCA BBS 


As a new user (the first time you dial the BBS), you are required to enter a 
user name and password of your choice. If you forget either your user name 
or password, call TSG to provide required information to access the BBS. 
New users have the right to view all files on the DCA BBS that are not 
password-protected, such as product tech tips, README files, frequently 
asked questions, and utilities. 


You can upgrade your rights by contacting TSG. For instance, you may want 
to be able to upload and download files from several conferences. You can 
also access software as well as text files. 


Tips for using the DCA BBS 


¢ DCA uses the PK(UN)ZIP.EXE programs to compact files on the BBS in 
order to conserve space and optimize the time you spend downloading 


files. If you do not have these programs, you can download both programs 
from the BBS. 
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¢ Compact your disks when uploading using the PKZIP.EXE program to 
optimize the time you spend on the BBS. 


¢ If you know the file that, you want to download, you can download the file 
without knowing where it is. When you access the File Downloads area, 
enter the name exactly as you have received it and proceed with the 
download process. 


Appendix A 


¢ If you have problems connecting to the DCA BBS, check your modem 
settings first. 


e If you receive a busy signal consistently when you are trying to connect to 
the BBS, your modem may be configured incorrectly. Check your modem 
configuration. If the problem persists, contact TSG for assistance. 


° Ifthe BBS number you are dialing does not answer, check your modem 
configuration. If the problem persists, contact TSG for assistance. 


When submitting an issue electronically, be sure to include all the information 
on the "Technical Support Information Sheet" in the following section. 


Internet and CompuServe access 


To find out how to contact us through the Internet or CompuServe™, call 
your local support hotline. 


Other technical support options 


More comprehensive technical support packages are available from DCA. 
The SupportWorks technical support services programs offer a wide range of 
base (complimentary) services in addition to several tiers of expanded 
services designed to help you implement and maintain your DCA products 
most effectively. In the United States and Canada, these programs provide 
extensive coverage, such as: 


¢ Fifteen-minute to 2-hour response times 
¢ Toll-free telephone access 
¢ Walk-through installations 


* On-site visits from Senior Support Analysts 


If you are located in the United States, Canada, or Latin America, call your 
account representative at (800) 348-3221 and ask about Standard, Classic, 
Enhanced, and Premium SupportWorks offerings for more information. 
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Note The SupportWorks offerings vary from country to country. The information 
provided here is for the United States and Canada. For International Support 
Services, contact your local DCA distributor, DCA account representative, or 
TSG for details. 


Obtaining product information through the DCA FAX Appendix 1 
Connection 


(404) 442-4035 


You can access the DCA FAX Connection to obtain current information about 
all of DCA's product offerings, including pricing, technical tips, and general 
product information. Simply call the number and you will be electronically 
guided through the system. During the process, you must provide a fax 
number to designate where to send the requested documents. 


Technical support information sheet 


When contacting TSG by phone or by electronic means, be prepared to 
provide the information described here: 


reproduce the 
problem 


i iia Information 
requested Example Your entry 
Product and Irma Suite 3.0 
version number 
Connectivity type Mainframe 

Modem 

Gateway/server NetWare for SAA 
Transport IPX 
Transport vendor Novell 
Transport version 3.10 
Error number and NOV162-TCPIP 
message connection fail 
Problem 
description 
Steps to 
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Please provide the following reports based on the type of problem that is 


occurring: 
Problem type Report requested 
General protection fault MSD report and Dr. Watson report. 
Appendix / 
Connection or link failure Trace of communications activity and 
system log. 
Installation or Printed configuration file and system log. 
configuration error 
Agent installation error Agent's MSD report, Agent's 


WSAGENT.LOG, and *.INI file listing 
from Agent installation media. 


Script error Script and Agent's WSAGENT.LOG. 
Transport error MSD report. 
Other errors MSD report. 


Obtaining product upgrades 


DCA periodically updates its software to add features or to correct reported 
problems. If you are covered under the DCAdvantage Upgrade Maintenance 
Plan, all of these releases will be sent to you automatically. If you are not 
covered, you may be required to purchase product upgrades if you desire. 


For more information regarding the annual DCAdvantage Upgrade 
Maintenance Plan, or for one-time product upgrades, contact your local DCA 
account representative. 


Replacing software disks 


To receive a replacement disk during the warranty period, contact DCA TSG 
in the United States or your international distributor. If you are calling DCA, 
ask to speak to a technical support analyst who will verify the problem and 
arrange to replace the disk, if necessary. Return the disk, postage prepaid, by 
means of a traceable carrier, to DCA at one of the addresses shown here. 
DCA does not accept disks that have been sent C.O.D. In addition, you must 
insure any item being returned to DCA. DCA is not responsible for any items 
lost or damaged in transit. 
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Address 


United States and Canadian customers should mail the disk, postage prepaid, 
to the following address: 


Appendix A Digital Communications Associates, Inc. 
Technical Services Group 
1000 Alderman Drive 
Alpharetta, GA 30202-4199 


Customers outside the United States and Canada should contact their dealers 
or distributors to replace a disk. 


Replacement disks are shipped by a method of DCA's choosing. If you desire 
a different shipping method, or are located outside the United States, you 
must bear the cost of shipment. Please use a street address as a return address; 
DCA does not ship items to a Post Office box. 


Returning hardware or software 


If for any reason you need to return a DCA product, use the Return Form 
included in your package. If you are returning an evaluation or product for 
credit, call your DCA account representative 1-800-348-3221 to obtain an 
RM# (return of merchandise number). 


If you cannot locate the Return Form, used the procedure and form provided 
here. 


Hardware return information 


If you believe you have a hardware problem, please call DCA TSG or your 
international distributor or dealer before you remove or disconnect your DCA 
product. You may be asked to perform some diagnostics that require you to 
leave the unit installed to determine the nature of the problem. 


There is no charge for the repair or replacement of hardware under warranty. 
DCA will repair units not under warranty at the prevailing rates. If the 
hardware is not under warranty and there is a charge, DCA requires a hard- 
copy purchase order, a letter of intent to pay, or a charge card number (Visa, 
Master Card, or American Express). Contact TSG for further details. 
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Returning hardware for repair, an evaluation product, or 
a product for credit 


The following procedure explains how to return hardware for repair, return an 
evaluation product, or return a product for credit: 


1 Ifyou are calling from the United States or Canada, call your DCA account 
representative at 1-800-348-3221 to obtain an RM# (return of merchandise 
number). 


If you are calling from anywhere outside of United States or Canada, 
contact your international distributor or dealer to obtain an RM#. 


For Hardware Returns: If you are returning hardware, have your product 
serial number on hand when you call. 


2 Copy and then complete the DCA Return Form located in the next section. 


3 If possible, pack the hardware or software in its original container. If the 
original container is unavailable, be sure to wrap hardware in non-static 
material such as newspaper and pack it in a sturdy, cardboard container. 


Note lf you are returning hardware for repair, return only the unit; do not 
return accessories, such as cables, disks, or documentation, 
unless otherwise instructed. 


4 Insert the completed DCA Return Form on top of the hardware or software 
inside the box before sealing. 


5 If you are mailing from the United States or Canada, mail the unit by 
prepaid postage, by means of a traceable carrier, to the following address: 


Digital Communications Associates, Inc. 
Attention: RM# 

1000 Alderman Drive 

Alpharetta, GA 30202-4199 


Customers outside the United States and Canada should mail the package, 
postage prepaid, by means of a traceable carrier, to their distributors. 


Note DCA does not accept packages that have been sent C.O.D., nor 
do we accept packages that lack an RM# clearly marked on the 
address of the package, excluding a product being returned for 
exchange (see the next section, “Returning a product for 
exchange’). 
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Returning a product for exchange 


If you are returning a product for exchange, follow this procedure: 


1 
2 


Copy and then complete the DCA Return Form located in the next section. 


If possible, pack the hardware or software in its original container. If the 
original container is unavailable, be sure to wrap hardware in non-static 
material such as newspaper and pack it in a sturdy, cardboard container. 


Note _ If you are returning hardware for repair, return only the unit; do not 
return accessories, such as cables, disks, or documentation, 
unless otherwise instructed. 


Insert the completed DCA Return Form on top of the hardware or software 
inside the box before sealing. 


If you are mailing from the United States or Canada, mail the unit by 
prepaid postage, by means of a traceable carrier, to the following address: 


Digital Communications Associates, Inc. 
Attention: Product for Exchange 

1000 Alderman Drive 

Alpharetta, GA 30202-4199 


Customers outside the United States and Canada should mail the package, 
postage prepaid, by means of a traceable carrier, to their distributors. 


Note DCA does not accept packages that have been sent C.O.D. 


DCA return form 


Check one of the following: 


Returning product for credit 
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Returning an evaluation unit 
for credit 


Returning product for 
exchange 


Returning hardware unit for 
repair 


RM# (not required for 
exchanges) 


Date 

Contact name 
Phone 
Address 


Customer Identification 
number 


Purchase order number 
DCA contact name 

Product name 

Product version 

Serial number (if applicable) 
Reason for return 


Place of purchase | 


Date of purchase 


Note lf this is a warranty repair, you must attach proof of purchase. 
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T 
tables, copying and pasting, 1-10 
task list, explanation of, x 
TCP/IP, 1-5 
text, copying and pasting, 1-10 
3Com, 2-5, 2-9 
TN3270 
checklist, 2-11 
software requirements, 2-9 
supported adapters, 2-5 
support for, 1-5 
TN3279 printing, 1-8 
token-ring, 1-4 


trace files, 1-16 

.TRC (trace file extension), 1-16 
TrueType fonts, 1-7 

tutorial for online help, 4-6 
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user alerts, 1-8 


V 
VINES, 1-5 
VTAM, 2-6 


W 

Walker Richer & Quinn 
mainframe connectivity, 2-9 
used with TN3270, 1-5, 2-5 

window size, 1-15 

Windows NT, 2-8 

Windows Open Systems Architecture 

(WOSA), 1-7 

Windows for Workgroups, 2-6 

WinHLLAPI, 1-7 

Winsock 
Client support, 1-6 
mainframe connectivity, 2-9 
used with TN3270, 1-5, 2-5 

Wollongong Pathway Access 
mainframe connectivity, 2-9 
used with TN3270, 2-5 


X.25, 1-4 
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We Need Your Comments 


After you’ ve used the product documentation, please give us your comments on this manual and the 
online help by completing this form and returning it to DCA. Your comments will help us improve 
our product. 


1 Which information do you use most? o Online o Printed 


2 Did you find any errors in the manual or online help? 


o Yes o No 
If so, please list the page numbers or online topic and describe the error: 


3 Did you look up a topic in the manual’s index that you couldn’t find? 


a Yes qo No 
If so, please list the topic: 
4 Does the manual adequately explain how to install the product? 
go Yes qo No 
If not, what information is missing? 
5 What part of this manual do you use most? 
6 How often do you expect to refer to this manual? 
oc Never o Once © Occasionally o Often 
7 Is the level of detail provided in the manual: 
© Too little go About right oc Too much 
If not enough information, what information is missing? 
If too much information, what information do you not need? 
8 How do you look for information in a manual? 
q Scan the book © Refer to the Table of Contents | Look up topics in the index 
9 Does the manual adequately prepare you to use online help? 
o Yes go No 
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10 Are you able to move through the online help, leave the online help, and return to your starting 
point without problems? o Yes o No 


If not, what problem did you encounter? 


11 How would you compare DCA’s online help to the online help you’ ve used for 
other products? o Poor o Average o Good o Excellent 


Comments: ee eee 
What online help have you used for other PC packages? 


12 Is the level of detail provided in the online help? 


© Too little o About right 0 Too much 
If not enough information, what information is missing? 


If too much information, what information do you not need or want? 


13 Do you have any other comments about the overall quality of this documentation? 


Please tell us about yourself: 
Your name 

Company name 

Your title /key function 


Years of PC experience 


Address 
Country Phone 
May we contact you about your comments? o Yes oO No 
Please send your comments to: DCA 
Attn: Information Services 
1000 Alderman Drive 
Alpharetta, Georgia 30202-4199 
U.S.A. 


Irma for the Mainframe Getting Started 
Guide 032959 
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—=—Attachmate.. 
3617 13ist Ave. S.E. 


Bellevue, Washington 98006 
Printed in U.S.A. 


Irma 


032629 Rev. B 


Turning ordinary information into a wealth of working knowledge. 


